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BWS-1000 Z80 Monitor Program 


1.0 INTRODUCTION 


1.1 General Description 
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ByteWyde Systems BWS-1000 Z80 monitor program is 
a high performance stand alone terminal based monitor utility 
- package suitable for use on any STD bus-based Z80 microprocessing 
system. It is designed to provide a support environment 
for the development of STD-based hardware, simple stand alone 
software, and for the debugging of larger software packages which 
have been assembled on a host development system. The 
monitor is particularly suitable to assist with the development 
of real-time interrupt driven software, such as multi-tasking 
operating systems or instrumentation software. 


A comprehensive range of functions are provided as standard, 
with further enhanced functions available when ByteWyde 
Systems BWS-2000 Hardware Debug card is included as an 
option. | 


STANDARD FUNCTIONS: 


. examine/alter memory bytes and words 

. display/copy/verify memory blocks 

. £111/clear/test memory blocks 

. input/output bytes through I/O ports 

. display/examine/alter/set CPU registers and register 
pairs 

- jump to commence program execution 

- set up to 16 simultaneous software breakpoints in user 

programs (RAM based program only). 

select breakpoint re-entry display format (one of 4) 

send/receive memory dumps as INTEL-HEX FORMAT files 

display help menu, describing functions available 

talk to host CPU (terminal mode) 


ADDITIONAL FUNCTIONS SUPPORTED BY THE BWS-2000 HARDWARE DEBUG CARD 


. Single step any user program (ROM or RAM based) 

. set a breakpoint trap on address bus access to any 
memory location 

- multiple passes through software breakpoints 
before re-entering the monitor 

. warm boot from “hung” user programs to avoid re- 
initialising registers, breakpoints, etc. 
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BWS-1000 Z80 Monitor Program 
1.0 Introduction (contd) 


The monitor is currently configured to be used with Prolog's 
new 7806 stand alone Z80 microprocessor card, as well as with the 
Prolog 7803,7804,7880 Z80 microprocessor cards (when combined 
with either the 7301 or 7304 serial UART cards). Other Z80 cards 
can be easily accommodated by minor revisions to the monitor BIOS 
subroutines, 


1.2 Operation 


The monitor is supplied in a single 2732 or 2764 EPROM. 
Details of the hardware configuration to be set up for the Z80 
card (and UART card if required) are given in this manual which 
is supplied with the EPROM. No other support software or 
operating system is required for the monitor to operate, 
although host systems can communicate with the monitor using the 
INTEL-HEX file transfer facility. 


The monitor program occupies addresses OOOO to OFFF Hex, and 
hence will commence execution from a Z80 RESET. All software 
restart and interrupt jumps are vectored through monitor RAM to 
allow a user program to access the interrupt structure. The 
monitor uses the RST 3 software restart for software breakpoints. 
If the BWS-2000 Hardware Debug card is installed, the monitor 
uses the NMI interrupt for hardware breakpoint functions. 


The monitor recognises the presence of the BWS-2000 Hardware 
Debug card in a system, so this card may be retro-fitted at any 
time. When the monitor recognises the Hardware Debug card in the 
system, it will ring the terminal bell upon a cold boot. 


User programs should not use the monitor's stack area, 
especially if it is desired to use the monitor's software trace 
facilities. User programs requiring a stack should initialise the 
stack pointer as necessary. Of course, user programs should not 
use the monitor RAM area, and expect the monitor to work. 
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BWS-1LOOO Z30 Monitor Program 


2.0 HARDWARE REQUIREMENTS AND CONFIGURATION 
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The minimum STD system necessary to run the BWS-1000 Z80 
monitor program must include: 


; one STD 280 processor card, Prolog types 7806, 7503, 
7804, 7830, or equivalent. 
at least one RS-232C serial port. The standard baud rate 
for communication to the VDU is 9000 baud. 

‘ ROM address space from OOOO Hex to OFFF Hex. 

; 200 Hex locations of RAM, located as discussed below. 

. Une terminal VDU, with RS-232C serial interface. 


If it is desired to use the monitor's INTEL-HEX load and transmit 
functions, a second RS-232C serial port must be installed into the 
system. The default baud rate for this port is 2400 baud. 


Tne BYWS-1000 Z80 monitor program resides in one Intel 2732 
EPROM or equivalent, and occupies addresses OOOO through OFFF Hex. 
Program parameters and stack require some 200 Hex locations of 
RAM, which is usually at the start of a 6116 RAM. The address of 
the monitor RAM area depends on the particular STD Z80 processor 
card in use. 


The following versions of the BWS-1000 monitor program match 
the particular Prolog Z80 processor cards listed: 


BWS-1O000 -~-- Prolog 7806-0 Z80 processor card 

BWS-1001 ---- Prolog 7806-1 Z80 processor card 

BWS-1002  ---- Prolog 7803 Z80 processor card with Prolog 
7304 dual UART card 

BWS-1003. ---- Prolog 7804 and 7880 Z80 processor cards 


with Prolog 7304 dual UART card 
BWS-1009 ----  CP/M-80 version 


For each of the BWS-1000 Z80 monitor program versions listed 
above, ‘the specific hardware configuration requirements are 
discussed below. For unique configurations not covered by this 
discussion (especially for different baud rates and different 
memory maps), contact ByteWyde Systems for further details. 


NOTES: 1) Prolog's 7806-0 and 7806-1 Z80 processor cards have 
slightly different clock rates. This affects the BAUD 
rate of the RS-232C serial ports. 

2) Users must be careful to order the correct version of 
the BWS-1000 Z80 monitor program to suit their 
particular Prolog Z80 processor card as indicated 
above. 
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2.0 Hardware Requirements and Configuration (contd) 


2.1 Prolog 7806 280 Processor Card - Monitor BWS-1000 & BWS-1001 
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The 7806 card provides all necessary hardware 
facilities on one card, 1.6. two R5-2320 serial ports and four 28 
pin JEDEC memory sockets. Links on this card must be set up to 
the factory installation, with memory mapping option ©, as per 
the Prolog manual, to provide: 


. Memory socket O address mapped to OO000 to OFFF Hex 
as 2/732 or 2764 type EPROM. 

. Memory socket 1 address mapped to 1000 to 1FFF Hex 
for user use. 

. Memory socket 2 address mapped to 2000 to 2FFF Hex 
for user use. 

. Memory socket 3 address mapped to 3000 to 37FF Hex 
as 6116 type RAN. 

. oerial Port 1 set up as Data Communication Equipment 


In addition, Serial Port 2 should be set up as Data Terminal Equipment. 


The terminal VDU is connected to Serial port 1, which is 
initialised to 9600 baud, 8 data bits, no parity bit, 1 stop bit, 
no interrupts. CTS and DSR are asserted. 


RS-232C connections for port 1 are as follows: 


pin 1 protective ground 

pin 2 data received by 7806 card 

pin 3 data transmitted from 7806 card 

pin 4 RTS sensed by 7806 card (not used by monitor) 
pin 3 CTS asserted by 7806 card 

pin 6& DSR asserted by data terminal 

pin 7 Signal ground 

pin 20 DTR sensed by 7806 card (not used by monitor) 


Serial port 2 is initialised to 2400 baud, & data bits, no 
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parity bits,1 stop bit, no interrupts. DTR and RTS are asserted. 


RS-232C connections for port 2 are as follows: 


pin 1 protective ground 

pin 2 data transmitted from 7806 card 

pin 3 data received from 7806 card 

pin 4 RTS asserted by 7806 card 

pin 3 CTS sensed by 7806 card (not used by monitor) 
pin 6 DSR sensed by 7806 card (not used by monitor) 
pin 7 signai ground ~ 

pin 20 DTR asserted by 7806 card 


NOTE: Consult the 7806 processor manual to convert serial port 2 
to Data Gommunication Equipment. The monitor is unaffected. 


BWS-1Q00 Z80 Monitor Program 


2.0 Hardware Requirements and Configuration (contd) 


To install the BWS-1000 ZSO monitor program insert EPROM 
BWS-1O0Q or BWS-1001 as appropiate into memory socket O and a 
oll6 RAM chip into memory socket 3. Set the 7806 card links as 
specified and insert it into an STD card frame. Connect the 
terminal, turn on the power, press pushbutton reset, and the 
monitor should display a sign-on prompt on the VDU terminal. No 
otner initialisation is required. 


2.2 Prolog 7803 280 Processor Card -  sfonitor BWS-1002 
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The 7603 card requires a separate dual UJA&T card to support 
the BWS-1000 Z80 monitor program. The standard monitor version 
(BWS-1002) assumes the Prolog 7304 dual UART card is installed in 
the system. Setup requirements for this UART card are discussed 
in section 2.5. 


Links on the 7/7803 card itself must be set up to the factory 
installation as per the Prolog manual, to provide: 


. Memory socket O address mapped to OOOO to O7FF Hex 
as 2716 type EPROM. 

. Memory socket 1 address mapped to O800 to OFFF Hex 
as 2/716 type EPROM. 

. Memory socket 2 address mapped to 1000 to 17FF Hex 
for user use. 

. Memory socket 3 address mapped to 1800 to IFFF Hex 
for user use. 

. RAM memory sockets mapped to 2000 Hex to 2FFF Hex 


To install the BWS-1000 Z80 monitor program, insert the two 
EPROMs comprising the BWS-1002 monitor program into memory 
sockets O and 1, and 2114 RAM chips into the memory RAM sockets. 
Set the 7803 card links as specified and insert it into an STD 
card frame. Set the 7304 card links as described in section 2.4, 
and insert it into the STD card frame. Connect the terminal, turn 
on the power, press pushbutton reset, and the monitor should 
display a sign-on prompt on the VDU terminal. No other 
initialisation is required. 
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BwS-1000 Z80 Nonitor Program 
2.0 Hardware Requirements and Configuration (contd) 


2.3 Prolog 7804 Z80 Processor Card ~ Monitor BiV/S-1003 
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The 7804 card requires a separate dual UART card to support 
the wS-1000 Z80 monitor program. The standard monitor version 
(3S-1002) assumes that the Proloz 7304 dual UART card is 
installez in the system. Setup recuirements for this UART card 
are discussed in section 2.5. 


Links on the 7804 card must be set up to the factory 
installation as per the Prolog manual, to provide: 


. viemory socket O address mapped to JUOUO to OFFF Hex 
as 2/732 type EPROM. 

. -‘lemory socket 1 address mapped to 1000 to IIFF Hex 
for user use. 

. tlemory socket 2 address mapped to 2000 to 2FFF Hex 
for user use. 

. ilemory socxet 3 address mapped to 3000 to 37FF Hex 
as 6116 type RAM. 


To install the BWS-1000 Z30 monitor program, insert EPROM 
BWS-1003 into memory socket O, and a 6116 RAM chip into memory 
socket 3. Set the 7804 card links as specified and insert it into 
an STD card frame. Set the 7304 card links as described in 
section 2.4, and insert it into the STD card frame. Connect the 
terminal, turn on the power, press pushbutton reset, and the 
monitor should display a sign-on prompt on the VDU terminal. No 
other initialisation is required. | 


The 7880 card requires a separate dual UART card to support 
the BWS-1000 Z80 monitor program, The standard monitor version 
(BWS-1003) assumes that the Prolog 7304 dual UART card is 
installed in the system. Setup requirements for this UART card 
are discussed in section 2.5. 


Links on the 7880 card must be set up to the factory 
installation as per the Prolog manual, to vrovide: 


. Memory socket O address mapped to 0000 to OFIFF Hex 
as 2/32 type EPROM. 
. Memory socket 1 address mapped to 3000 to 37FF Hex 
as 6116 type RAM. 
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BWS-1000 Z80 “ionitor Program 
2.Q Hardware Requirements and Configuration (contd) 


To install the BWS5-1000 ZO monitor program, insert EPROM 
BWS-1003 into memory socket 0, and a 61169 RAM chip into memory 
socket 1. Set the 7880 card links as specified and insert it into 
an STD card frame. Set the 7304 card links as described in 
section 2.4, and insert it into the STD card frame. Connect the 
terminal, turn on tne power, press pushbutton reset, and the 
monitor should display a sign-on prompt on the VOU terminal. No 
other initialisation is required. 


2.9 Prolog 7304 Dual UART Card 
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The Prolog 7304 dual UART card provides the serial ports 
Tj a7 


required for the é&TITLia Z3éU inonitor program to work with any of 
tne Prolog 7803, 7304, 7360 processor cards. 


Links on the 7304 card must be set up to the factory 
installation as per the Prolog manual, to provide: 


. Card addressing at I/O location EO hex. 
. otandard baud rate selection. 
. Channel A configured as DCE, channel B configured as DTE. 


The terminal VDU is connected to channel A, which is 
initialised to 9600 baud, 8 data bits, no parity bit, 1 stop bit, 
no interrupts. CTS and DSR are asserted. 


RS—-232C connections for channel A are as follows: 


pin 1] protective ground 

pin 2 data received by 7304 card 

pin 3 data transmitted from 7304 card 

pin 4 RTS sensed by 7304 card (not used by monitor) 
pin 5 CTS asserted by 7304 card 

pin 6 DSR asserted by data terminal 

pin 7 Signal ground 

pin 20 DTR sensed by 7304 card act used by monitor) 


Channel B is initialised to 2400 baud, 8 data bits, no 
parity bits,l stop bit, no interrupts. DTR and RTS are asserted. 


RS-232C connections for port 2 are as follows: 


pin 1 protective ground 

pin 2 data transmitted from 7304 card 

pin 3 data received from 7304 card 

pin 4 RTS asserted by 7304 card 

pin 5 CTS sensed by 7304 card (not used by monitor) 
pin 6 DSR sensed by 7304 card (not used by monitor) 
pin 7 Signal ground 

pin 20 DTR asserted by 7304 card 
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3.0 COMMAND SUMMARY AND SYNTAX 
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Display a command summary 

Hexadecimal addition/subtraction calculator 
Jump to Command Basic (if installed) 

Talk to host CPU (terminal mode) 


Memory Examination/Modification: 


, Se oe 


o<<- 7 


Display memory block in Hex and ASCII 
Memory byte examine/alter 
Memory word examines/alter/trace 


Fill a memory block with a constant 
Copy a memory block 
Verify (compare) two memory blocks 
Test a memory block 


Register Examination/Modification: 


P 
x 


Register, byte wide, examine/alter 
Register pair, word wide, examine/alter/trace 
Display complete saved CPU state 


I/O Data Transfer: 


0 
I 


Output data via I/O port 
Input data via I/Q port 


Program Execution Control: 


1S) 


2 


INTEL-HEX File 


L 


Go to target execution address 

Single step the target code (only with Hardware 
Debug card ) 

 Jet/examine/remove software breakpoints 

Set/examine/remove hardware address compare 
breakpoint Conly with Hardware Debug card) 

vet/alter breakpoint display flag 


Transfer: 


Load a memory image from an INTEL-HEX format file 
received via the auxiliary serial port 
Upload a memory image as an INTEL-HEX format 
file via the auxiliary serial port 
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3.0 Command Summary and Syntax (contd) 


3.2 Command syntax 
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BvwS-l00U monitor commands consist of a one letter (case 
irrelevant) command character, and are generally followed by one 
or more hex numeric parameters appropriate to the command 
function. These numeric parameters may be separated by either a 
comma or a space. Command lines are interpreted by the monitor 
when terminated with a Carriage Return (CR). A backspace 
character may be used to ‘'rubout' erroneous characters in a 
command line before the CR is entered. 


When monitor commands cause a long display to be sent to the 
terminal screen (such as a long memory dump), the display can be 
paused, or frozen, at any time by typing any key (except CR which 
causes a return to prompt level). Once frozen, any other key will 
resume the display output to the screen. 

Invalid commands will cause the prompt "Command Error !". 
re-enter the correct command on a new line. If the BWS-2000 
Hardware Debug card is not installed, commands which require this 
card will not execute, but will generate the Command Error prompt. 


If the BWS-2000 Hardware Debug card is installed, the monitor 
can be "warm booted" at any time by pressing the push button on 
the debug card. This warm boot removes any breakpoint 
instructions that were inserted into the target code, but does 
not re-initialise breakpoints, register values, etc that have 
been set within the monitor. 


The monitor may be "cold booted" at any time by entering a 
"control R" character. In addition, the monitor will execute a 
"jMP 0000" instruction at any time by entering a "control C" 
character. This function performs a cold boot for ROM based 
monitor versions, and a return to CP/M for the CP/M based 
monitor. 
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BWS-1000 Z80 Monitor Program 
3.0 Command Summary and Syntax (contd) 


3.3 Symbol Definitions 
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aaaa - Hexadecimal 16 bit address 
dd - Hexadecimal 8 bit data 
dddd - Hexadecimal 16 bit data 
char - ASCII character 

n ~ Decimal count 


start,end,new — Hexadecimal memory addresses 


port - 8 bit 1/0 port address 
is - Single register names; 
A (a) A' (a') Main & alternate accumulators 


F (f£) F' (£') Main & alternate flags (SZ_H VNC) 


C 
D (d) D' (d') Main & alternate 

E (e) E' (e') 8 bit general purpose 
H (h) H' (h') registers 

L 


Pp - Register pairs; 
AF (a) A'F' (a') Main & alt. accumulator and flags 
BC (b) B'C' (b') Main & alternate 
DE (d) D'E' (d') 16 bit general purpose 
HL (h) H'L' (h') register pairs 


IX (x) Index register Ix 
IY (y) Index register IY 


SP (s) Stack pointer 


PC (p) Program counter 
INT (i) Interrupt Vector and Status 
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4.0 COMMAND DESCRIPTIONS a 


Syntax: 2 


Parameters: none 


Display a summary of all BWS-1000 commands (except '?'). 


NOTE: The command summary display includes all BWS-1000 monitor 
functions, including the additional functions that require 
the BWS-2000 Hardware Debug card to be installed. However, 
if these additional command functions are invoked without 
the Hardware Debug card in the system, the monitor will 
return a Command Error. 
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4.0 Command Descriptions (contd) A 
AA AA 
A A 
AAAAAAA 
4.2 Set/Examine/Remove Hardware Address Compare A A 
Ee een ene Oe ies cel ieee ein ete eae AOA 


WARNING: This function requires the BWS-2000 Hardware Debug 
card. Invoking this function without the debug card will cause a 
Command Error. 


Syntax: A 
Aaaaa 
Aaaaa,n 
Parameters: aaaa = hardware address 
n = matching loop count (O means clear) 
"A' -— Display the current address compare location in the format: 
address on count 
where: 
address = address of breakpoint 
n = .pass count (number of address matches before 
a return to monitor prompt level) 
count = number of address matches that have occured 
"Aaaaa' -— Set the hardware address compare facility of the BWS- 


2000 Hardware Debug card to the specified address. When 

an instruction is executed (Ml cycle) with matching address 

on the bus an NMI is generated and the monitor is re-entered. 

The message "Address match at dddd 4 Break = aaaa" and the 

appropriate CPU status as determined by the breakpoint "Z" 
flag are printed, and the monitor returns to prompt level. 


"Aaaaa,n' - Set the hardware address compare as above, and loop 
"n" address matches before returning to monitor prompt 
level. The CPU status will be printed at each loop and/or at 
the final monitor re-entry as determined by the breakpoint 
"Z"" flag. The command can be terminated before the "n" passes 
have been completed by typing a CR, which is detected at the 


next monitor re-entry. 


"Aaaaa,O' - Cancel the address comparison at the specified 
location. (Actually the compare address is set to FFFF, — 
which is UNLIKELY to be accessed by a normal program). 
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4.0 Command Descriptions (contd) .BBBBB 
_ B B 
BBBBB 
; Bias ob 
4.3  Set/Examine/Remove Software Breakpoints BBBBB 
syntax B 
Baaaa 
Baaaa,n 
Parameters; aaaa = breakpoint address 


n breakpoint loop count (O means clear) 


- Display the active software breakpoints in the format: 


address n count 
where: 


address = address of breakpoint 

n = pass count (number of passes through the 
breakpoint before a return to monitor 
prompt level) 

count = number of breakpoint passes that have occured 


'Baaaa' - Set up a software breakpoint at the specified 


'Baaaa,n' . —- Set up a software breakpoint as above, and loop ‘n 


address. When the user program is (re)started using the 'G' 
command, a RST 3 instruction (opcode= DF hex, vector 

@18 hex) temporarily replaces the instruction in the target 

code, and thus causes a monitor re-entry on execution of the 
instruction. The message "Break = aaaa"’ and the appropriate 

CPU status is printed, and the monitor returns to the prompt 
level. 


woe 


address matches before returning to monitor prompt level. 
The CPU status will be printed at each loop and/or at the 
final monitor re-entry as determined by the breakpoint "Z" 
flag. The command can be terminated before the "n" passes 
have been completed by typing a CR, which is detected at the 


next monitor re-entry. 


"Baaaa,O"' -—- Clear the software breakpoint at the specified 


address 
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BWS~1000 Z80 Monitor Program 
4.0 Command Descriptions (contd) 
4.3  Set/Examine/Remove Breakpoints (contd) 


NOTES ON BREAKPOINTS 


- Software breakpoints can only be inserted into RAM based 
user program. Use the hardware address compare facility or 
the single step facility of the BWS-2U00 Hardware Debug card 
if a breakpoint or a trace through RO! based code is 
desired. 


. The breakpoint table is currently 16 deep, allowing 16 
breakpoints to be active simultaneously. A diagnostic is 
displayed if the user attempts to overflow this table. 


; Breakpoints which may be multiply passed during user program 
execution must be treated with some caution without the 
BWS-2000 Hardware Debug card. When the monitor restarts a 
user program after a software breakpoint is encountered, the 
original instruction is replaced into the user program for 
execution. If the Hardware Debug card is installed, the 
monitor single steps over this instruction, and then 
replaces it again with the software breakpoint RST 3 
instruction to allow for multiple passes through the 
breakpoint. If the Hardware Debug card is NOT installed, the 
breakpoint instruction will not be re-inserted into the user 
code until the next monitor re-entry occurs, and thus 
multiple pass breakpoints may not occur. 


The solution when‘the Hardware Debug card is NOT installed 
is to insert TWO or more software breakpoints into a loop 
where multiple loop breakpoints are desired. As each 
breakpoint is encountered, the other breakpoint instructions 
will be replaced into the user program as the monitor 
restarts the program after the breakpoint. 
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BWS-1000 Z80 Monitor Program 
4.0 Command Descriptions (contd) 
4.3  Set/Examine/Remove Breakpoints (contd) 


Example: Consider a program loop between 1000h and 1100h. To 
successfully break at each pass of the loop at say 
address 1003h (with the next instruction at address 
1005h), insert breakpoints as follows:- | 


B1003 
B1005 


At each pass of the loop; 


a software breakpoint will occur at address 1003h, 
the software breakpoint at address 1005h will be 
inserted, the original instruction at address 
1003h will be replaced and executed; 


a software breakpoint will occur at address 1005h, 
the software breakpoint at address 1003h will be 
inserted, the original instruction at address 
1005h will be replaced and executed; 


CCCs 
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4.0 Command Descriptions (contd) 


4.49 Call Command Basic (if installed) 
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Syntax: C 


Parameters: 


Call ByteWyde Systems BW5-1100 Command Basic, 


BWS-1000 Z80 Monitor Program 


none 


ol 
Cl 


Ls Oe 


installed with the BWS-1900G monitor program. 


Note: This command will cold boot the monitor if Command Basic 


is not installed. 


NOTE: This function is not yet implemented 


if this lanquage is 
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4.0 Command Descriptions (contd) DDDDD 
D WD 
D D 
D D 
4.5 Display a Memory Block D ») 
~~-—~—-—~-- +--+ + ~----- DDDDDD 
syntax D 
Dstart 


Dstart,end 


Parameters: start 
end 


Start of memory dump 
end of memory dump 
(default = start + 100h) 


Display the specified memory block in hex and ASCII. If end 
is not specified then it defaults to start + 100 hex. If start is 
not specified, then it defaults to the previous end value. 


The display can be temporarily halted by typing any 


character other than CR, and restarted by typing any character. 
The display can be terminated at any time by typing CR. 
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4.0 Command Descriptions (contd) FFFFFFF 
i 
FFFF 
F 
4.6 Fill a Memory Block F 
Syntax: Fstart,end,dd 
Parameters: Start = start of memory dump 
end = end of memory dump 
dd = data to put into memory 


The memory block: 
Start --—> end 


is filled with the specified value (dd). 
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Command Descriptions (contd) GGGGG 
G G 
G 
G GG 
Go to Target Execution Address G G 
——------- - ~ - - + +--+ - GGGGG 
Syntax: G 
Gaaaa 
Parameters: aaaa = target execution address 


The CPU state is totally restored from the saved state and 


execution of the target code is resumed. If an address is 
specified, this value is loaded into the program counter (PC) 
before transfer to the target code. If any software breakpoints 
have been set up (using the B command), the appropriate target 
code instructions are replaced with RST 3 instruction before 
target code execution commences. 


NOTE: 


The current loop count for software breakpoints, 
hardware address match and single step are reset to 
zero before execution transfers to the target code. 
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4.0 Command Descriptions (contd) H H 
H H 
HHHHHHH 
H H 
H H 


4.8 Hexadecimal Calculator 


syntax: Hexpression 


Parameters: expression = hexadecimal expression to 
evaluate 


The hexadecimal expression is evaluated, and the result 
displayed in hexadecimal format. The only legal operators 


accepted by this command are '+' and '-', 


This function can be used to determine the two's complement 
of a number by using the command: 


H—dddd 
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4.0 Command Descriptions (contd) ap EEE 
4.9 Input Data via I/O Port I 


Syntax:  Iport 


Parameters: port = 8 bit I/O port 


The data input from the specified port is displayed as a two 
digit hexadecimal number. 


4.11 Rev 1.1 


BWS-1000 Z80 Monitor Program 


4.0 Command Descriptions (contd) K 
K K 
KK 
K K 
4.10 Copy a Memory Block K 
Bee itd at Mace eel K 
syntax: Kstart,end,new 
Parameters: start = start of old memory block 
end = end of old memory block 
new = Start of new memory block 


The memory block: 
Start ~-> end 
is copied into the block: 
new --> new + (start—end) 


byte by byte in ascending address order using an LDIR 
instruction. 
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4.0 Command Descriptions (contd) 


4.11 Load an INTEL-HEX Format File 


ew er ee we ee ee eee ee we cee erg ee rp 88 eee ee eee ee oe ee ee ee ee ee ee oe ee ee 


LLLLLL 


syntax: L 
Ldddd 
Parameters: dddd = load offset constant 


An INTEL~HEX format file is loaded into memory via the 
auxiliary serial port. If an offset is specified this modifies 
the default load address specified in the hex records. 


Before commencing the load, the monitor will pass on a 
single command line, entered from the terminal, through the 
auxiliary serial port. In effect, the monitor goes into terminal 
mode for one line entry. This command line can be used to trigger 
the transmission of the INTEL-HEX file from the host CPU. Note 
that the host CPU is responsible for echoing this message; no 
local echo is provided by the monitor. The prompt "J" indicates 
that the monitor is ready to pass on the single command line 
through the auxiliary serial port. 


The single command line must be terminated with a CR, which 
is also passed up through the auxiliary serial port, and the 
monitor then expects the downline load to commence immediately. 


The hex file may be simultaneously displayed on the console as 
it is loaded. This display may be toggled on/off by typing 
control V. 


If a checksum error is detected, the load will abort with an 
error message, 
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4.0 Command Descriptions (contd) MM MM 
MMMM 
M M M 
M M 
4.12 Examine/Alter Memory Byte M M 
Syntax: Maaaa 
Parameters: aaaa = address to examine/alter 


The address and current contents are displayed in the 
format: 
aaaa dd 
User responses may be: 


CR ‘move to the next byte location 


~ move to the previous byte location 


dd replace the current contents with the new hex 
value (2 digits long), then move to the next byte 
location 

"char replace the current contents with the ASCII value 


of the entered character, then move to the next 
byte location (upper case only). 


other return to prompt 
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4,0 Command Descriptions (contd) O00 


4,13 Output Data via I/O Port 0 


Syntax: Oport,dd 
Parameters: port = § bit I/O port address 


dd = & bit data to be output 


The 8 bit data value is output to the specified port. 
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nd Descriptions (contd) PPPPPP 
Pp 
PPPPPP 
—_ 

ne/Alter/Trace Register Pair —p 


syntax: Pp 
Pp' 
Parameters: p = register pair selection 
p' = alternate register pair selection 
where p=a_ AF and p' = a' AF' 
b BC b' BC! 
d DE d' DE’ 
h HL h* HL 
x IX © 
y. LY 
s SP 
p PC 
i INT 
The current register pair's name and contents are displayed 


in the format: 


User respo 
CR 


@ 


dddd 


p dddd 
nses may be: 
move to next register pair 


change to display of memory word (W command) using 
the contents of the displayed register pair as the 
current address 


replaces the contents of the displayed register 
pair with the new 16 bit hex value, then moves to 
the next register pair 7 


returns to prompt level 


The 16 bit hex numbers must be terminated by a carriage 
return. Less than 4 digits are right justified, with 
unentered digits set to zero. If more than 4 digits are 
entered then only the 4 rightmost digits are accepted. 


The Interrupt register pair comprises the Z80 interrupt 
vector register in the high byte. Bit 2 of the low 

byte determines whether interrupts are enabled or 
disabled on entry to a user program, i.e. 


Bit 2 
Bit 2 


O - Disable Interrupts on program entry 
1 ~ Enable Interrupts on program entry 
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4.0 Command Descriptions (contd) QQQ 
| Q Q 
Q 
Q QQ 
4.15 Test a Memory Block Q 
~~---~------------- QQQ Q 
Syntax: Qstart,end 
Parameters: Start = start of memory block to be tested 


end end of memory block to be tested 

The memory block: 

start --> end 

is tested by a simple write/readback test with a test 
number incremented at each memory location and at the end of each 
pass through the test block of memory. After each complete pass 
through the memory block a '+' is displayed. 

The message: 

address dd should = nn 
is displayed for each location in error. 
Type carriage return to abandon the test and return to 


monitor prompt level. 


NOTE: Memory is tested in blocks of 100 hex. The test address 
range should therefore be multiples of 100 hex for the 
-- test to work correctly. . ~~ 
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4.0 Command Descriptions (contd) RRRRRR 
R R 
RRRRRR 
RR 
4,16 Examine/Alter Single Register R R 
Syntax: RY 
Rr! 
Parameters: r = single register selection 
r' = alternate single register selection 
where: r= a A r' =a’ A! 
ae f°. 
b B Bb BS 
é ¢ Ee 
d D d' D! 
e E e' £' 
h dH A He 
1 osL 1 1! 
flags (F F') contain: S sign 
Z zero 
H half carry 
in order: SZ_H_VNC V overflow/parity 
N add/subtract 
C carry 


The current register's name and contents are displayed in 
the format: 


r dd 
User responses may be 
CR move to the next byte register 
dd replaces the current contents of the byte 
register with the new 8 bit data, then moves to 


the next byte register. 


other return to prompt level 
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4.0 Command Descriptions (contd) SSSS 
S S 
SSS 
; SSS 
* 4,17 Single Step Target Code S oS 
Peete see eae So SSS 


WARNING: This function requires the BWS-2000 Hardware Debug 
card. Invoking this function without the debug card will cause a 
Command Error. 


Syntax: S 
on 


Parameters: mn = number of instructions to step 


Single step the target code by one (or n) instructions, then 
return to monitor prompt level. 


This facility utilizes the hardware count down facility of 
the Hardware Debug card to generate an NMI during execution of 
the next instruction of the target code. Stepping over n 
instructions is accomplished within the monitor by re-entering 
the target code until the required number of target instructions 
have been executed. 


NOTE: The current loop count for software breakpoints, 
hardware address match and single step are reset to 
zero before execution transfers to the target code. 
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4.0 Command Descriptions (contd) TITTTIT 


a aa aa ea 


4.18 Talk to host CPU 


ees ee OP em, ee ee es OED OEE ee eee oe ee ee owe ee 


syntax: T 


Parameters: none 


All subsequent characters entered at the system terminal are 
passed directly on through the auxiliary serial port. All 
characters received through the auxiliary serial port are 
displayed on the system terminal. No intermediate character 
processing occurs. 


Characters entered from the system terminal in this mode are 
passed onto the auxiliary serial port as 7 bit ASCII characters. 
Transmission from the serial port is controlled by the parity 
setting of the auxiliary serial port (initialised to 8 data bits, 
no parity). 


The terminal mode may be terminated by entering "cntrl E" at 
the system terminal, whereby the monitor returns to its normal 
mode. 


NOTE: When entering terminal mode, the monitor does NOT 
flush a character which may have been received at the 
auxiliary serial port. Such a character will be 
displayed as the first character received when the 
terminal mode is entered. 
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4,0 Command Descriptions (contd) U U 
y 7 
U U 
mi) U 
4.19 Upload an INTEL-HEX Format File YUU 
Syntax: Ustart,end 
Parameters: start = start of memory block to be 
transmitted 
end = end of memory block to be 
transmitted 


The memory block: 
Start --—> end 


is transmitted in INTEL-HEX format via the auxiliary serial 
port. 


The hex file may be simultaneously displayed on the console 
as it is transmitted. This console display may be toggled on/off 
by typing control V. The upload procedure may also be aborted at 
any time by typing control R. | 
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4.0 Command Descriptions (contd) V 


4.20 Compare (Verify) Two Memory Blocks 


Syntax: Vstart,end,new 
Parameters: start = start of first memory block 
end = end of first memory block 
new = start of second memory block 
The blocks of memory: 
start --> end 
new -—> new + (start-—end) 


are compared. The error message; 
address dd should = nn 


is displayed for each mismatched byte. 
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4.0 Command Descriptions (contd) Ww W 
W W WwW 
WWW W 
yW WW 
4,21 Examine/Alter/Trace Memory Word | WW WW 
oyntax: Waaaa 
Parameters: aaaa = address of word to be examined 


The current address and current contents are displayed in 
the format: 7 


aaaa dddd 


User responses may be: 


NOTE: 


CR 


move to next word location 
move to previous word location 


current address is set to the currently displayed 
location contents. 


replaces current contents of location, then moves 
to next word location. 


returns to prompt level 


The 16 bit hex numbers must be terminated by a carriage 
return. Less than 4 digits are right justified, with 
unentered digits set to zero. If more than 4 digits are 
entered then only the 4 rightmost digits are accepted. 
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4.90 Command Descriptions (contd) X X 
X X 
XX 
X X 
4,22 Displayed Saved CPU State X X 


— en ee eee eee Se SUES OD Cee ee SS Oe ee Oe ee wee coe ee oe oe oe oe Oe oe 


syntax: X 


Parameters: none 


Display the complete status of the CPU, that is the status 
saved away upon monitor re-entry and subsequently modified by 


either the R or P commands. 
The following are displayed: 
~ CPU registers: 


Set flags (displayed symbolically) 
Register pairs 


for both the main and alternate register banks. 
~ Current value of the I register. 


- The interrupt status of the target code. 


The display format is as follows: 


AF BC DE HL IX TY SP PC OP 

SZ H VNC dddd dddd dddd dddd dddd dddd dddd dddd dd 
SZ_H_VNC dddd dddd dddd dddd dd E/D 

ay / + 

flags I register Interrupt status 
NOTE: OP is the next opcode to be executed at the location 

specified by PC 
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4,0 Command Descriptions (contd) LLLLLLL 
Z 
Z 
LL 
4.23 Set/Alter Breakpoint Display Flag Z 
—-~-~--~-—--—~--—--------------------- LLLLLL 
Syntax Z 
Zdd 
Parameters: dd = flag status byte 
'Z' - Display the current value of the breakpoint display flag 


in the format: 


dd 


'Zdd' -— Set the breakpoint display flag according to the status 
code dd. This flag controls the response of the monitor at 
re-entry. Only the two least significant bits of the flag 
byte have any relevance, as follows: 


bit O SET - £display the CPU status (X command) on each 
monitor re-entry, EXCEPT the terminating re- 
entry, that is, the one that causes a 
return to prompt level. 


bit 1 SET - display the CPU status (X command) upon 
return to monitor prompt level. 


The most useful values for the flag are therefore: 


O no display of CPU status at all 


2 display CPU status only upon return to prompt 
level 
3 display CPU status upon each re-entry 
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MONITOR ENTRY POINTS 


eee ese ie ee 


eee eee ee 


The BWS-1000 monitor uses a number otf general purpose subroutines 


for initialisation, canscole I/O and serial port I/0. These 
subroutines can be accessed from user programs by simply CALLing 
the routines at the monitor subroutine jump table. 


The subroutines and their jump address are as follows: 


Address (hex) Label Subroutine Function 
0080 .cold Monitor cold boot Cinitialisation) 
0083 »warm Monitor warm boot 
0086 — const Console status test (A=0 if ready, 
a A=FF if not) 
0089 | .conin Console data input (data in A) 
OO08C -conout Console data output (data in ©) 
OO8F .conig 8 bit console data input (data in A) 
0092 -remst Auxillary port status test (A=0 if 
ready, A=FEF if not) 
0095 .remin Auxiliary port data input (data in A) 
0098 -remout Auxiliary port data output (data in ©) 
OO9B -remi8 8 bit auxiliary port data input (data in A) 
OO9E ~p2hx Display A as 2 hex digits on console 
OOA1 »pahx Display HL as 4 hex digits on console 
OOA4 -porlf Display CR/LF on console 
OOA7 »pmsg Print (HL)-> string up to EOT 
OOAA -pnext Print string following call up to EOT 
OOAD ~g2hx Get 2 hex digits into A from console buffer 
OOBO -94hx Get 4 hex digits into HL from console buffer 
OOB3 -glin Get new line from console 
OOBE etalk Talk through auxiliary port to remote host 
OOBY »rhex Load hex file from auxiliary port 
OOBC .shex send (updump) hex file through auxiliary port 
OOBF »-passcl [end ons command line to remote host 
00c2 einit Initialise bios 
0OGC5 sMLLE Initialise Monitor RAM and bios 
Example: CALL 0080 will cold boot the monitor 
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5.0 tonitor Entry Points 
(contd) 


5.2 Interrupt Jump Vectors 


Swe Swans eae mgs <amee Gee eoeee eupes cme Gees eee ae eee eee ee eee wore coe ee ee eee oe 


the BWS-1000 monitor vectors all software and hardware 
restart jumps tc tne monitor RAN, to allow access from user 
orozrams. rour bytes are reserved in the monitor RAM for each 
restart vector, to allow a furthar jump instruction to be 
inserted as required, 

the #5T 3 and the Neil restarts are vectored back into the 
monitor at monitor initialisation. The other restart- address are 


‘Ee 


Cita ed “43-4 a -2 e ANSEPUCE LON. 


The restart Ar vectors are located at the start of monitor 
hAe. Phe absolute location of the vectors depends on the 
particular Prolog Zs6U processor card in use. Aelocatable locations 
are as follows. UVonsult the load map stapled to the back of this 
manual for the absolute address of the start of the RAN vector 
locations. 


Relocatable Label Initialised To Comments 
Address 

RAM Vis Start of Monitor RAM 
OO00 RSTI VEC RET Pr yer FE Jump from 08 hex 
QO004 RSTZ VEC REP, PL be ee Junp from 10 hex 
QU06 RST3_ VEC JP RST ENT, TF Jump from 18 hex 

(monitor software breakpoint) 

QOQ0C RST4 VEC RED EE sue Jump from 20 hex 
0010 RSTS5_ViEC Ref hire be Jump from 28 hex 
0014 RST6_VEC RET,FF,FF,FF Jump from 30 hex 
0018 RST7_ VEC ig Oe ee Jump from 38 hex 


(maskable interrupt ) 


OO1C NMI VEC JP NMI ENT, FF Jump from 66 hex 
(monitor restart, single step, 
address halt) 


0020 MON VEC RET,FE,FF,FF Command Table Extension 
0024 M RETUR DI, RET Return to Target Code 
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APPENDIX A - COMMAND SYNTAX SUMMARY 


me we ew om ee cee eee re ese woe 


Aaaaa,n 
Baaaa,n 

G 

Dstart,end 
Fstart,end,dd 
Gaaaa 
Hexpressicon 
Iport 
Kstart,end,new 


tmnt 


Maaaa 
Gport 

Pp 
Qstart,end 
Rr 

on 

T 
Ustart,end 
Vstart,end,new 
Waaaa 

X 

an 


0 mt meee eee ee eee ee 


Display a4 command summary 
Set/examine/remove address compare 
~et/examine/remove software breakpoints 


Call Command Basic (if installed) 


Display memory block 

Fill a memory black 

Go to target execution address 
Hexadecimal calculator 

Input data via i/o port 

Lopy a memory hiock 

Load an INTEL-HEX format file 
Examine/alter memory byte 

Output data via i/o port ; 
Examine/alter/trace register pair ~ 
Testa memory block 

Examine/alter single register 
Single step target code _ 

Talk to hast CPU 

Transmit an INTEL-HEX format file 
Compare (verify) two memory blocks 
Examine/alter/trace memory word 
Display saved CPU state 

set/alter breakpoint display flag 


Execute JMP O000 instruction 

Cold boot the monitor 

Toggle the upload/load console display 
Abort uploading or loading a hex file 


Fi, i 
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O70 
4309 
4318 


Iaead 


Lore 


nmosFr 
maak 
GoaecS 


ooa+ 


qugs 
none 
aia 
1453 
mead 
i4Ba 
nhigiR 
mgos 
viiz 
N=fiR 
vies 
OS73 
Goede 
42058 
47345 


4208 


= I oP Se a eS 
« {3 
Soh GD ke SOA SR sy i yg 


PRD Co oy ho “A Pa Pe a Oo fo 8 


om o 
a en Se 


oo 
‘sage 
owen 

m 
ee 
eee 


t 


4, of CS 


mn 
oe ya 


“yoda, 


ry 
tos 


“ 
Mca 
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-GLZHA 
~MZNET 


~PORLF: 


»RETMIN 
» SHEN 
(@RHE X 
GET SHA 
MON IN 
"UT SHAWN 
.¥VfiNS 
.Vigin 
.¥V¥DU 
RETCHR 
INIT VD 
FUTSTA 
ENDTBL 
ATTRIB 
CaLTEBL 
FLAG 
LOTBL 


. VEC_LN 


ESETRL 
BRIGHT 
CLRLSTF 
CSEN | 
& SUP 
CURSON 


DIiSPUF _ 
ESCEMEB 


INSL IN 
NGRMAL 
SELESD 


SETATT 


VDT MH 
VDEIMS 
VDOIM? 
RUSBLIF 
be 4S thi 
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midis 
uViar 
O403 
OSS 
o2o3 
o567 
F2uc 
gz D0 
G75 
42702 
ISAC 
42F7 
O22C 
O2ZEE 
O3I# 
4209 
42705 
cg 77 
o457 
O4FOe£ 
03D 
0462 
O44 
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1 fra, 


Moh Ur Ga fa och bet pr 


Bil 
shee 


NMZ_VE 
RST4_V 
. VSTAR 
$C ONST 


SREMGU 


.CONIN 
. HN 
«P2HX 
. PMSG 
. REMGU 
- TALK 
(@SHE NX 
GET 4HX 
MON_WA 
PUT 4H5 
.VEGLD 
-VEEYI 
.VVDUT 
GETSTA 
KEYE 
VDU 
STRTBL 
CHARSE 
COLMRT 
INI@LP 
OUTPTR 
VEC_ST 
CTLVEC 
CADDR 
CSDYWN 
CSRET 
CURHOR 
CURVAT 
DISFON 


FLSHOF 


INVGFF 
ROVHEN 
SELES 
SRCHTE 
VDZrMa 
VDTr4 
YBU2 
KEY RUF 


i KEY? 


CRTBL 
ERTBL 
PEVECT 
LINSIZ 
@FILL 
@MEMDM 
@REGDU 
aVERCM 
CRLFS 
MON_ST 
M OPH 
FARAMS 
GLIF PLT 
@DUMP 


eae 
Mae ii 


pe my Be fy 


mom an ait cn Ga ta 


ho 


MOUND TOUR 


one 
lever? 
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pees) 
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f) it Wh tl bout 


hao CS ath ats 


OIE 
aiid 
O21 
ayo 
HFA 
O54F 
oiz7 
42710 
4#2>00 
42718 
O78? 
4300 
OIF 
420F 
O345 
Se ae | 
on? Er 
O23E 


O3B4 


Q2AF 
Ott F 
04f06 


_ 0455 


O465 
O4F7E 


O¢35 


Ni -f-f 
f244 
fF > 
sag 
O6SE 
QSEE 
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I0ise 
OF 25 
OF OD 
OcIig 
OF Lf 
OSBF 
$3370 


4328 


IQEE 
14AE 
QFFE 


~C GNU 
-LliN 
aP4Hy 
~aFREAT 
~REMST 
. ARM 
@TALE 
ETLIN 
FMSia 
~-¥VOIN 
»¥VE@oT 
»~¥VEEYS 
- YAR 
INZGTE 


KEYSTA 


VELL CG 
VECTBRL 
CHRON 
CTECTFBL 
INITEE 
RAM VE 
fai ocaL 
CTLIBL 


CLRALL 


CSHOME 
eSkGT 
CURFOGS 
DELL IN 
DSv¥AT 
FLSHUGN 
LNVGN 
SAVEAT 
SELES? 
ULNGFF 
VDIMI 
VDIMS 
AFQS 
SHARIN 
ifiP FR 
CRVEL 
ERVES 


PIGA 
@aBLOockK 


@FLAG 
@agUuT cm 
@REGIS 
@VIEW 
GETHENX 
MON VE 
M_ Fo 
BP FIN 
FUT 2HS 
MDATA 


pt lise 
Ghaid 
Fear ban is 
os eS 
noe 
Gue6é 
noe 2 
QORF 


a 


Coo 
nouns 
I2F2 
14Zz3 
isa24 
14c4 
nays 
ajs4 
mye. 
HiD8 
Ni 38 
Si F 
O{3E 
agia 
0334 
o566 
4704 
4#70D 
F795 
O27 
0337 
G2DE 


q2ne 


O45F 
(BFE 
G36] 
Lait 
“379 
oO3eo 
0471 
C416 


O437— 


Ogg 7 
q25¢ 
naa 
4205 
OS6F 
C567 
o595 
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@FASSL 
CRLF 
MON £2 
PNET 
-VEINT 
a ViGLUIT 
. 4MATH 
mainaArhy 
INZITIG 
FLT CHR 
VBU &#A 
LeéTcTseR 
CLRSCN 
DEFATT 
INKEY 
TIMER 
ESCVEE 
BELLGN 
CLREOS 
CSLFT 
CSRSP 
CURS&F 
BZ 
ERAE@L 
GETREC 
MoVEDN 
SCROLL 
GELESS 
ULNGN 
VDIM2 
VbiMé 
YRos 
CHAREL 
GUTTER Y 
ETRIBL 
INTTBL 
PIOB 
@BRREAK 


126A/@GOTO 


oeDS 
137 
OF SD 
4337 
acis 


~da2 


i4EA 
F3F BR 
43335 


@aPATR 
@SENT 
@PORD 
LZNELF 
MS FRM 


ECHO 
REG_It4 
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